APPENDIX J 

SWITCH SUMMARIES 


J.l DSKINT Switches 


Switch 

Name 

Example 

****NORMAL MODE SWITCHES**** 

Operation 

/L 

List 

#DP0:/L 

Lists the contents of the 
BADB. SYS file at the prin- 
ter for the specified RP03 
disk. 

/M 

Enter 

MARK 

Mode 

#DP1:/M 

Changes DSKINT to MARK mode; 
DSKINT indicates MARK mode 
with * at the terminal. The 
RP03 will also be initialized 

/R 

Retain 

#DP2:/V/R 

Retains BADB. SYS file on 
an initialized disk, and 
includes that informa- 
tion in x the new BADB . SYS 
file when re-initializ- 
ing the disk. 

A 

Verify 

#DP:/V 

Verifies and zeroes an 
entire disk. 

/z 

Zero 

#DP3:/Z 

Performs basic disk ini- 
tialization: 


a. Verify blocks 0 and 
1, and any other 
blocks reserved for 
DOS/BATCH file struc- 
ture . 

b. . Zero the entire disk. 

c. Write file directories, 
bit maps, and BADB. 

SYS onto the disk. 

Enter [1,1] and the 

„ current UIC into the 

MFD. 

****MARK MODE SWITCHES**** 

/° Done ^65/M/D Causes DSKINT to leave 

MARK mode, but continue 
disk initialization; at 
cCmpletion, control re- 
turns to Monitor. 


A Used in the following formats: bbbbbb/M (or U) and ccc:ttrss/M (or U) where 
bbbbbb is an octal block address; and ccc, tt, and ss are octal cylinder, track, 
and sector addresses. 
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Switch 

Name 

Example 

Operation 

/L 

List 

^DP0:/L 

Lists contents of BADB. 
SYS file at printer for 
the specified disk. 

/M 1 

Mark 

*43/M 

^43:32: 3/M 

Directs DSKINT to enter 
the BADB. SYS file at the 
specified address. 

/u 1 

Unmark 

*64/U 
*47 :4:2/U 
^73/M/U 

Deletes a specified ad- 
dress from the BADB. SYS 
file, or ignores a pre- 
viously specified /M 
switch on a command line 

J.2 FILCOM 

Switches 



Switch 

Name 

Example 

Operation 



**** LOCAL SWITCHES**** 


/BL 

Blank Lines 


When OFF, blank lines 
are compared in files; 
when ON, blank lines are 
ignored during compari- 
son. 

/DE 

Delete 

Existing 


When present, existing 
dataset of same name as 
that specified in com- 
mand is deleted; when 
not present, deletion is 
not performed. 

/'MB 

Multiple 

Blanks 


When present, reduces 
multiple blanks to a 
single space during com- 
parison; when not pres- 
ent, multiple blanks are 
compared individually. 

/SC 

Source 

Compare 

% 

Specifies the number of 
consecutive lines to be 
compared to establish a 
successful comparison. 

/TR 

TRailing 

Blanks 

****GLOBAL SWITCHES**** 

When ON, trailing blanks 
are ignored during com- 
parison; when OFF, trail 
ing blanks are compared. 

/DF 

Define 

DeFault 


Allows user to specify 
default conditions for 


one or more LOCAL swit- 
ches. 


*Used in the following formats: bbbbbb/M (or U) and ccc:tt:ss/M (or U) where 
bbbbbb is an octal block address; and ccc, tt, and ss are octal cylinder, track, 
and sector addresses. 
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Switch 

Name 

Example 

operation 

/IN 

INdirect 

commands 


Specifies dataset con- 
taining file to be read 
and interpreted as FIL- 
CQM commands. 

/LO 

LOg dataset 


Specifies log dataset 
for subsequent commands. 

/LS 

r 

List dataset 


Specifies list dataset 
for subsequent commands. 

J. 3 FILDMP 

Switches 

****INPUT SWITCHES**** 


Switch 

Name 

Example 

Operation 

/BL 

BLock 

LP:<DT1:/BL:3:7 

Dumps blocks 3, 4, 5, 6, 
and 7 from DTI to line 
printer in octal word 
format . 

/CH 

/ 

CHain 

KB : <DK0 : FILE/CH 

Lists the numbers of the 
blocks which FILE occupies. 

/FA 

Formatted 

ASCII 

LP:<DK0: FILE/FA 

Dumps FILE to the line 
printer in octal word 
format, but reads FILE 
in formatted ASCII mode. 

/FB 

Formatted 

Binary 

LP : <DF : F I LE/FB 

Dumps FILE to the line 
printer in octal word 
format, but reads FILE 
in formatted binary mode. 

none 

Unformatted 

Binary 

LP : <DF0 : FILE 

Dumps FILE to the line 
printer in octal word 
format, but reads FILE 
in unformatted binary 
mode . 



****OUTPUT SWITCHES**** 


/AS 

ASCII 

LP :/AS<DFsFILE 

Reads FILE in unformat- 
ted binary mode and dumps 
to the line printer in 

ASCII mode; i.e., one 

ASCII character per byte. 

/BY 

Octal 

BYtes 

LP : /BY <DK0 : F ILE 

Reads FILE in unformat- 
ted binary mode and 
dumps to the. line prin- 
ter as a sequence of 
octal bytes. 
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Switch 

Name 

Example 

Operation 

/OC 

Octal 

words 

LP : /OC<DF i FILE 

Reads FILE in unformatted 
binary mode and dumps it to 
the line printer as a 
sequence of octal words. 

/'RA 

Unpacked 

Radix-50 

LP:/RA<DK0:FILE . 

Reads FILE in unformat- 
ted binary mode and dumps 
it to the line printer in 
unpacked Radix-50 form 
format, i.e.,3 charac-~ 
ters per word. 

None 

Octal Words 

LP:<DK0:FILE 

' Same as /OC. 


J.4 FORTRAN Switches 


/AS and /LI may appear only on the output side of a FORTRAN command string. All 
other switches must appear only on the input side. 


Switch 


/AS 


Name Example 

****OUTPUT SWITCHES**** 


Assembly 

Output 


/LI ; n List 

Control 


****INPUT SWITCHES**** 


/CK Check Bounds 


/CO:n Continuation 


Operation 


Produces assembly code - 
output instead of an 
object module; default 
filename extension is 
.PAL, not .OBJ. 

Default, n=l. 
n=0, lists block sum- 
maries only; 
n=l, source listing and 
block summaries; 
n=2, assembly code, source 
listing, and block 
summaries; 

n=3, symbol table, as- 
sembly code , source 
listing, and block 
summaries. 


Checks all array sub- 
scripts for upper bound, 
as dimensioned in pro- 
gram. 

Sets maximum -allowable 
continuation lines; 
0<n<99; default, n=5. 
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Switch 


Name 


Example 


/ER Special Error 

Listing 


/GO Go 


/ON One 


/OP : n Optimization 


/SU Suppress 


Operation 

Prints special advisory 
diagnostics (S codes) on 
questionable or certain 
non-ANSI statements. 

Calls LINK after compila- 
tion for compile-load- 
go; any F error during 
compilation aborts this 
action and gives the 
message EXECUTION DELETED. 

Allocates one storage 
word (instead of two) 
for all integer and logi- 
cal variables. (PDP-11 
FORTRAN integers have 
only one word of preci- 
sion, even if two are 
allocated.) Use this 
switch carefully rela- 
tive to EQUIVALENCE 
statements . 

Generates code for the" 
most efficient hardware 
use; default, n=l. 

n=0, no optimization; use 
with TRACE. 

n=l, optimizes integer 
add and subtract 
operations, and 
array references. 
n=2, optimizes integer 

add, subtract, mul- 
tiply, and divide 
operations (requires 
PDP-11/10, or PDP- 
11/20 with Extended 
Arithmetic Element, 
or PDP-11/40 with Ex- 
tended Instruction 
Set, or PDP-11/45) . 
n=3, optimizes floating- 
point arithmetic 
operations (requi- 
res PDP-11/45 with 
Floating-point Pro- 
cessor) , and inte- 
ger operations. 

Suppresses statement 
sequence numbers; saves 
two storage words per 
statement. Run-time 
error messages identify 
subroutine but not line 
number. 


J-5 



J.5 LIBR Switches 


Switch Name 

/D Delete 

/D : vl . . . : vn 


/I Insert 

/I : v 


/LO 


List 

Object 

Module 


/R 


Replace 


Example Operation 

j^DTl : LIBR. 1<DT2 : LIBR. 0/D :M1 :M2 Deletes one or more ob- 
ject modules (vl...vn) 
from the input library; 
do not use with /I or /R. 

#DT1:LIBR.1<DT2:LIBR.0,FIL.1/I:2,FIL.2/I 

Inserts one or more ob- 
ject modules into the 
input library; v is a 
decimal integer relative 
to the input library; 
modules are inserted 
starting at position v, 
otherwise they are ap- 
pended to the end of the 
input library. 

#_,,LP:FIL.LST/L0<DT1:LIB.1 Produces an object mod- 

ule listing to compare 
against an input library 
directory listing. 

#I)T1: LIBR. 1<DT2: LIBR. 0,FIL.1/R,FIL.2/R 

Replaces one or more ob- 
ject modules in the in- 
put library; the object 
modules must have the 
same name as the ones 
they replace. 


J.6 LINK Switches 


LINK switches comprise three groups: input, map and load module output. The input 
switches are B, CC, E, EX, GO, IN, L MP, 0, OD, T, and TR; the map switches are 
CR, LG, and SH; and the load module output switches are CO and SQ. 

Any extraneous value assigned to a switch is ignored. No switch except /OD should 
appear alone in an input specification; i.e., /E is illegal, but filename /E is 
legal. 


Switch Name Example 

****INPUT SWITCHES**** 


/Bsn Bottom 


Operation 


Controls placement or 
relocation of object 
program; n=unsigned oc- 
tal number that defines 
the bottom address of 
the object program. 
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Switch 

Name 

Example 

Operation 

/CC 

Concatenate 


Indicates that a file is 
a concatenation of sev- 
eral files. 

/E 

End 


Indicates end of input; 
should appear with last 
input file; should not 
be used with /GO. 

/EXsxxxxxx 

Exclude 

LIBRY/IN : ABC/EX : QKQ 

Excludes specified li- 
brary modules on library 
files; no effect if 
specified for nonlibrary 
files. 

/GO 

Go 


Indicates end of input, 
and, after linking, the 
loading and execution of 
the load module; should 
appear with the last in- 
put file, and should not 
be used with /E. 

/IN:xxxxxx 

Include 

FTNLIB/IN : $PSH01 

Includes specified li- 
brary modules on library 
files; no effect if 
specified for nonlibrary 
files. 

/L 

Library 


Indicates that an input 
file is a library; not 
needed for correct li- 
brary functioning with 
LINK; provides compati- 
bility with old linker. 

/MP 

Overlay Map- 
ping Descrip- 
tion 

“ 

„ Specifies the associated 
file as an ASCII overlay 
description; no other 
input files, values, or 
switches (other than /E 
are allowed in a command 
string with this switch. 

/o 

Option 


Specifies that LINK op- 
tions are required; re- 
places /E. 

/OD 

ODT 

SY : DEBUG . LDA<S Y : ODT . OBJ [1,1] /OD 

Links ODT with user's 
object modules; identi- 
fies associated input 
file as ODT for transfer 
addresses. Example shows 
equivalent of‘/OD appear- 
ing alone as an input 
file. 



J-7 

i 




Switch 

Name Example 

Operation 

/T:n 

Top 

Controls placement or re- 
location of object pro- 
gram; n-unsigned octal 
number that defines ad- 
dress of object program; 
default=top of available 
core. 

/TR 

/TR:n 

/TR: xxxxxx 

Transfer 

Address 

Without a value, directs 
LINK to take the trans- 
fer address (even or odd) 


of the first object mod- 
ule in the associated 
file as the transfer ad- 
dress of the load module. 
With n, uses value of n 
as transfer address of 
load module. With xxxxxx 
(global symbol) , uses 
value of symbol as trans- 
fer address of load mod- 
ule. (If xxxxxx does 
not exist, transfer ad- 
dress=l and an error 
message is issued.) 


****MAP SWITCHES**** 


/CR 


/LG 


/SH 


/CO 

/COsn 


Global 

Cross 

Reference 

Long Map 


Short Map 


Produces global cross- 
reference table on map 
listing device. 

Produces long map form 
on specified map file; 
includes entry points, 
globals, and externals 
referenced by the module. 

Produces short map on 
specified map file; in- 
cludes only heading, 
program size description, 
and section allocation 
synopsis. 


****LOAD MODULE OUTPUT SWITCHES**** 


Contiguous Specifies load module 

Output output file in contigu- 

ous format; required 
with overlaid programs. 

Using n (n=multiple of 
64) generates a contigu- 
ous file for another de- 
vice whose blocksize does 
not equal the blocksize 
of the current output 
device 1 . 
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Switch 

Name 

Example 

Operation 

/SQ 

Program 

Section 


Stores program sections 
(.PSECT, .CSECT) in the 


Sequencing 


order encountered by 
LINK, instead of alpha- 
betically. 


J.7 MACRO Switches 

Switch options specified on the output side apply to both the object and listing 
files. Switch options specified on the input side apply to the file that precedes 
the switch and all subsequent files. 


Switch 

Name 

. Example 

Operation 

/LI 

List 

#OBJF IL , LP : /LI <DTl : ABC 

Lists any source code 
normally suppressed. 

/LI : arg 

List 

#OBJFIL, KB/LI : SRC<DF : SRCFIL 

Formats the assembly 
listing to the argument 
specified. 

/NL 

Nolist 

#OBJFIL , SYM/NL< ABC 

Suppresses assembly 
listing. 

/NL : arg 

Nolist 

#OB JFIL , KB : /NL : BEX : COM< . . . 

Deletes the portion of 
the listing indicated by 
the argument. 

/EN : arg 

Enable 


Overrides any arguments 
specified on a .ENABL 
directive. 

/DS : arg 

Disable 


Overrides any arguments 
specified on a .DSABL 
directive. 

/CRF 

Cross- 

Reference 

# , LP : /CRF<FILE1 ,FILE2 

Calls CREF immediately 
after assembly; prints 
both assembly and CREF 
listing at line printer 

/CRF : arg 

Cross- 

Reference 

# , LP : /CRF : NG<F ILE 1 , F ILE2 

Postpones CREF action; 
prints only assembly 
listing and saves CREF 
listing creates FILE2.CRF 
containing CREF listing. 

/PA: 1 

Pass 1 


Assembles file during 
pass 1 only. 

/PA: 2 

Pass .2 


Assembles file during 
pass 2 only. 
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J.8 PIP Switches 


Switch 

Name 

Example 

Operation 

/AL 

Allocate 

#DF : FILE/AL : 10 

640 (10 x 64) contiguous 
words of file storage is 
allocated on disk. 

/BR 

Brief 

Directory 

£DT0:/BR 

Lists all filenames and 
extensions in directory 
for DEC tape 0 on the 
user's teleprinter. 

/CK 

Checksum 

_#DT s/Dl/CK 

Adds checksum information 
to each line of directory 
listings. 

/CO 

Contiguous 

£DT 0 : < ABC/CO 

Transfers file ABC as 
contiguous file from 
system disk to DECtape 0. 

' 


£DT0 : AD/CO<ABC , DEF 

Merges files ABC and DEF 
(on system disk) as one 
contiguous file on DEC- 
tape 0. 

/DE 

Delete 

£MAIN/DE 

Deletes file MAIN from 
system disk. 



£DT0 : ABC , DTI : DEF/DE 

Deletes files ABC and 

DEF from DECtape s 0 and 

1 respectively. 

/DI 

Directory 

£DT0:/DI 

Lists all filenames, ex- 
tensions, size, creation 
date, and protection 
codes in directory for 
DECtape 0 onto the user ' s 
teleprinter. 

/EN 

Enter 

£DF:/EN 

Enters current user's 

UIC in MFD on the speci- 
fied disk (device) . 

/FA 

Formatted 

ASCII 

£LP : /FA<DT0 : ABC 

Copies file ABC from DEC- 
tape 0 to line printer 
in formatted ASCII mode. 

/FB 

Formatted 

Binary 

£E>T0 : <ABC/FB 

Copies file ABC from sys- 
tem disk to DECtape 0 
in formatted binary mode. 

/FC 

Fast Copy 

£DT1 : <DT2 : /FC 

Data on DECtape #2 is 
fast copied onto DECtape 
#1. 

/FC/VE 

Fast Copy 
and Verify 

£DT1:<DT2: /FC/VE 

Data on DECtape #2 is 
fast copied and verified 
onto DECtape #1. 

/FR 

Free 

£DT1:/FR 

Lists the number of free 
blocks remaining on DEC- 
tape unit 1. 
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Switch 


Name 


/IN 


/PR 


/RE 


/RU 


/RW 


/SU 


/UA 


Example 
Inspect #* . */DE/IN 


Protect #ABC/PR: 355 

Rename #ABC/RE<DEF 

#DT0 : GHI/RE<DT0 : JKL 

Rewind and #MT1:/RU 

Unload 


Rewind #MT1:/RW 


Supersede #dev : <devl : A , B , C/SU 


Unformatted #LP : /UA<DT0 : ABC 
ASCII 


Operation 

Used in conjunction with 
file transfers and /SU, 
/DE, and /RE switches. 
Allows user to selective- 
ly perform the primary 
function. (User gives Y 
to perform action on the 
displayed file or types 
the RETURN key to leave 
file intact.) 

Change protection code of 
system disk file ABC to 
355. 

Rename file DEF to ABC. 

Rename DEC tape 0 file 
JKL to GHI. 

Causes the tape on mag- 
tape unit #1 to be wound 
back on its reel and the 
unit to be switched off- 
line. 

Causes the tape on mag- 
tape unit #1 to be wound 
back on its reel. The 
unit can still be address- 
ed. 

Causes files on the input 
side (DEVI) to replace 
files of the same name 
which may already be on 
the output device (dev) . 

Copies file ABC from DEC- 
tape 0 to line printer in 
unformatted ASCII mode. 


/UB Unformatted #DT0:<ABC/UB Copies file ABC from sys- 

Binary tern disk to DECtape 0 in 

unformatted binary mode. 


/UN 


Unlock 


#DF: FILE. OLD/UN 


/VE 


Verify 


#DT1:<DT2:/VE 


/VW 


Verified 

Write 


#CT : VW<CT1 : FILE . MAC 


/ZE 


Zero 


#DT0:/ZE 


Unlocks FILE. OLD after a 
system failure so that 
FILE. OLD can be accessed. 

Data on DECtape #1 and 
DECtape #2 are compared 
block-by-block; disagree- 
ments are shown by prin- 
ting block and word num- 
bers at the console. 

Verify a write opera- 
tion by reading it after 
writing it. 

Erases all files from 
directory of DECtape 0 
by initializing the file 
structure . 
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J.9 ROLLIN SWITCHES 


Switch 

Name 

Example 

Operation 

/BO: dev 

Bootstrap 

#/BO : DK 

Bootstraps DOS/BATCH; loads the first 
256 words of core from the specified 
device and branches to location 0. 

/DA : dd-mmm-yy 

Date 

#/DA: l-FEB-74 

Enters specified date in FILE LABEL 
on magtape. 

/FI 

Find 


Magtape use only: when reading, /FI 
rewinds the tape and searches for the 
specified file; when dumping, /FI 
skips all previously written files. 

/FO 

Format 


Used on the output side of a transfer 
command string to format a DECpack 
cartridge on an RK03/05 disk drive, 
or a disk pack on an RP11-C/RP03 disk 
drive before the transfer operation 
begins. 

/HE 

Help 


Types a brief explanation of ROLLIN 
options on the console. 

/NO 

Nolabel 


When dumping disk to DECtape this 
switch inhibits the REEL LABEL from 
being written. 

/NU:n 

Number 


n specifies the total number of units 
of disk space to transfer; a unit is 

IK processor words (K=1024) ; n may 
assume a maximum value as shown here. 




RC11 64 

RF11 256 

RK03/05 1200 

RP03 20000 

/PL : n 

Platters 


With RF11 and RC11 disks only, n is 
the number of disk platters to load or 
dump; default, n=l. 

/RW 

Rewind 


Rewinds magtape before reading or 
writing. 

/SK:n 

Skip 


Skips past n end-of-file marks before 
starting to read or write on magtape. 

/TR:n 

Track 


n specifies the unit of disk space at 
which to begin a transfer operation; 
see /NU for values n may assume; de- 
fault, n=0. 

/VE 

Verify 

- 

Used in image copy operations to en- 
sure a correct and readable copy. 

/WL 

Write Lock 


Used with a DECpack device designator 
to force a write lock on an input drive 


unit . 
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